Release 10.1A: OpenEdge Development:
Progress Dynamics Web Development Guide

Specifying the appropriate Progress Dynamics Broker

For standard WebSpeed applications, you specify a Broker in a URL (for example, WService=wsbroker1). However, for Progress Dynamics Web applications, the Broker is specified either in the default HTML layout file (default.htm), or through extension mapping on the Web server.

Specifying a Broker in the default HTML layout file

If you want to specify your Broker in the default HTML file (default.htm), you must set the dyn attribute to point to a Progress Dynamics Broker.

The markup should look similar to the bold text in the following:

<td id="app" dyn="/scripts/cgiip.exe/WService=wsdynamics1/dhtml" css="../dhtml/ryapp.css" timeout="20000" encoding="UTF-8" lognote="on">

You can have multiple Brokers running for a single Web server. However, a default HTML layout page can only be associated with one named Broker. If you have multiple Brokers, you must create a unique default HTML page for each Broker.

Specifying a Broker using extension mapping

Extension mapping associates the .icf extension with a named Progress Dynamics Broker, The .icf extension is generated when the Web server accesses default.htm in the /dhtml directory.

To enable extension mapping:

Verify that the dyn attribute in the default HTML layout file is not set to any value. (No value is the default setting.) The markup should look similar to the bold text in the following:

<td id="app" dyn="" css="../dhtml/ryapp.css" timeout="20000" encoding="UTF-8" lognote="on">

Note: A Broker specified in the dyn attribute overrides a Broker specified through extension mapping.
Configure your Web server. For specific information, see the "Configuring the IIS Web server" section or the "Configuring the Apache Web server" section. Refer to individual product documentation for other Web servers.

When you use extension mapping, only one Progress Dynamics Broker can be set up for the Web server.